Short:    MuLib based ROM Replacement Hack
Author:   thor@math.tu-berlin.de (Thomas Richter)
Uploader: thor@math.tu-berlin.de (Thomas Richter)
Version:  40.4
Type:     util/boot
Requires: util/libs/MMULib.lha Kickstart V37, 2MB chip, well-behaived board

______________________________________________________________________________

Changes made for 40.4:

The reset-and-stay resident mechanism of MuMapRom makes now use of the
ColdCapture exec vector and a nice little extra hack.

Adds now a 16MB "safety zone" around memory areas to keep some wierd memory
tests working.

Did not work at all if the "ROMINFAST" option was not present at the
command line. Should be much better now.

______________________________________________________________________________

MuMapRom is a mmu.library based "ROM kicker", i.e. it replaces the ROM
resident kickstart by a disk based image file. The purpose of MuMapRom
is mainly to replace the kickstart image temporarely for testing, e.g.
for program authors to test their programs under different environments.
It should not be used for permanent kickstart replacement.
______________________________________________________________________________

Top reasons why not to use this program:

- It is a hack. MuMapRom assumes several non-granted behaivours of
  the current Kickstart implementation, of the CPU and motherboard
  hardware.
- MuMapRom will not work in all available environments. It may cause
  some compatibility problems, depending on the board type, the
  hardware and the memory configuration.
- MuMapRom requires a lot of chip memory (See "Implementation" for
  details why this is so). In fact, it will only run on machines with
  2MB chip memory. A graphic card is recommended as otherwise not
  much chip memory is left.


If you need a new/different ROM for your system, you should rather:

- Buy the ROM chip and install it. This will definitely work, will be
  most robust and won't cause any problem. If you need two different
  ROM versions, hardware solutions are available that toggle between
  two ROMs.
- If you just need an upgrade of several system modules, other less
  hacky solutions exist. For example, to replace one ROM module by
  a ROM module of a later edition, you are encouraged to use the
  "LoadModule" and "MuProtectModules" of the same author.
- If you need short turn-around times for software testing, try to
  find a solution that is adapted to your board hardware 
  (e.g. CyberMap). These programs do not need to touch the MMU, but
  rather use board specific hardware for ROM remapping. This will
  typically do better since it will not require as much chip memory
  as this program.

If you still think that you "need" MuMapRom, please read the 
"MuMapRom.guide" file first. Experts might want to read the "Implementation"
chapter of the guide as well as it contains background information where
the MuMapRom restrictions arise from.

______________________________________________________________________________

                         The THOR-Software Licence (v2, 24th June 1998)


This License applies to the computer programs known as "mmu.library", 
"MuMapRom", "MuFastRom" and the corresponding documentation, known as
".readme" files. The "Program", below, refers to such program. The "Archive"
refers to the package of distribution, as prepared by the author of the
Program, Thomas Richter. Each licensee is addressed as "you".



The Program and the data in the archive are freely distributable
under the restrictions stated below, but are also Copyright (c)
Thomas Richter.

Distribution of the Program, the Archive and the data in the Archive by a
commercial organization without written permission from the author to any
third party is prohibited if any payment is made in connection with such
distribution, whether directly (as in payment for a copy of the Program) or
indirectly (as in payment for some service related to the Program, or
payment for some product or service that includes a copy of the Program
"without charge"; these are only examples, and not an exhaustive enumeration
of prohibited activities).


However, the following methods of distribution
involving payment shall not in and of themselves be a violation of this
restriction:


(i) Posting the Program on a public access information storage and
retrieval service for which a fee is received for retrieving information
(such as an on-line service), provided that the fee is not
content-dependent (i.e., the fee would be the same for retrieving the same
volume of information consisting of random data).


(ii) Distributing the Program on a CD-ROM, provided that

a) the Archive is reproduced entirely and verbatim on such CD-ROM, including
especially this licence agreement;

b) the CD-ROM is made available to the public for a nominal fee only,

c) a copy of the CD is made available to the author for free except for
shipment costs, and

d) provided further that all information on such CD-ROM is re-distributable
for non-commercial purposes without charge.


Redistribution of a modified version of the Archive, the Program or the
contents of the Archive is prohibited in any way, by any organization,
regardless whether commercial or non-commercial. Everything must be kept
together, in original and unmodified form.




Limitations.


THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY. THERE IS NO
WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE AND NON-INFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
SERVICING, REPAIR OR CORRECTION.


IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE THE PROGRAM, THE ARCHIVE
AND ALL DATA OF THIS ARCHIVE FROM YOUR STORAGE SYSTEM. YOU ACCEPT THIS
LICENCE BY USING OR REDISTRIBUTING THE PROGRAM.


                                                        Thomas Richter

______________________________________________________________________________


Happy ROM Kicking,

	Thomas Richter	(February 2002)
